home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1998 June / SGI Freeware 1998 June.iso / dist / fw_fileutils.idb / usr / freeware / catman / u_man / cat1 / cp.Z / cp
Text File  |  1998-05-21  |  6KB  |  200 lines
  1. /xlv1/freeware/1998.May/fileutils/3.16/fileutils-3.16.diffbuild/man
  2.  
  3.  
  4.  
  5.      CCCCPPPP((((1111))))         FFFFSSSSFFFF ((((GGGGNNNNUUUU FFFFiiiilllleeee UUUUttttiiiilllliiiittttiiiieeeessss))))         CCCCPPPP((((1111))))
  6.  
  7.  
  8.  
  9.      NNNNAAAAMMMMEEEE
  10.       cp - copy files
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       ccccpppp [options] source dest
  14.       ccccpppp [options] source... directory
  15.       Options:
  16.       [-abdfilprsuvxPR] [-S    backup-suffix] [-V
  17.       {numbered,existing,simple}] [--backup] [--no-dereference]
  18.       [--force] [--interactive] [--one-file-system]    [--preserve]
  19.       [--recursive]    [--update] [--verbose] [--suffix=backup-
  20.       suffix] [--version-control={numbered,existing,simple}]
  21.       [--archive] [--parents] [--link] [--symbolic-link] [--help]
  22.       [--version]
  23.  
  24.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  25.       This documentation is    no longer being    maintained and may be
  26.       inaccurate or    incomplete.  The Texinfo documentation is now
  27.       the authoritative source.
  28.  
  29.       This manual page documents the GNU version of    ccccpppp.  If    the
  30.       last argument    names an existing directory, ccccpppp    copies each
  31.       other    given file into    a file with the    same name in that
  32.       directory.  Otherwise, if only two files are given, it
  33.       copies the first onto    the second.  It    is an error if the
  34.       last argument    is not a directory and more than two files are
  35.       given.  By default, it does not copy directories.
  36.  
  37.     OOOOPPPPTTTTIIIIOOOONNNNSSSS
  38.       -_a, --_a_r_c_h_i_v_e
  39.            Preserve    as much    as possible of the structure and
  40.            attributes of the original files    in the copy.  The same
  41.            as -_d_p_R.
  42.  
  43.       -_b, --_b_a_c_k_u_p
  44.            Make backups of files that are about to be overwritten
  45.            or removed.
  46.  
  47.       -_d, --_n_o-_d_e_r_e_f_e_r_e_n_c_e
  48.            Copy symbolic links as symbolic links rather than
  49.            copying the files that they point to, and preserve hard
  50.            link relationships between source files in the copies.
  51.  
  52.       -_f, --_f_o_r_c_e
  53.            Remove existing destination files.
  54.  
  55.       -_i, --_i_n_t_e_r_a_c_t_i_v_e
  56.            Prompt whether to overwrite existing regular
  57.            destination files.
  58.  
  59.       -_l, --_l_i_n_k
  60.            Make hard links instead of copies of non-directories.
  61.  
  62.  
  63.  
  64.      Page 1                         (printed 5/18/98)
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.      CCCCPPPP((((1111))))         FFFFSSSSFFFF ((((GGGGNNNNUUUU FFFFiiiilllleeee UUUUttttiiiilllliiiittttiiiieeeessss))))         CCCCPPPP((((1111))))
  72.  
  73.  
  74.  
  75.       -_P, --_p_a_r_e_n_t_s
  76.            Form the    name of    each destination file by appending to
  77.            the target directory a slash and    the specified name of
  78.            the source file.     The last argument given to ccccpppp must be
  79.            the name    of an existing directory.  For example,    the
  80.            command `cp --parents a/b/c existing_dir' copies    the
  81.            file _a/_b/_c to _e_x_i_s_t_i_n_g__d_i_r/_a/_b/_c, creating any missing
  82.            intermediate directories.
  83.  
  84.       -_p, --_p_r_e_s_e_r_v_e
  85.            Preserve    the original files' owner, group, permissions,
  86.            and timestamps.
  87.  
  88.       -_r   Copy directories    recursively, copying all non-
  89.            directories as if they were regular files.
  90.  
  91.       -_s, --_s_y_m_b_o_l_i_c-_l_i_n_k
  92.            Make symbolic links instead of copies of    non-
  93.            directories.  All source    filenames must be absolute
  94.            (starting with `/') unless the destination files    are in
  95.            the current directory.  This option produces an error
  96.            message on systems that do not support symbolic links.
  97.  
  98.       -_u, --_u_p_d_a_t_e
  99.            Do not copy a nondirectory that has an existing
  100.            destination with    the same or newer modification time.
  101.  
  102.       -_v, --_v_e_r_b_o_s_e
  103.            Print the name of each file before copying it.
  104.  
  105.       -_x, --_o_n_e-_f_i_l_e-_s_y_s_t_e_m
  106.            Skip subdirectories that    are on different filesystems
  107.            from the    one that the copy started on.
  108.  
  109.       -_R, --_r_e_c_u_r_s_i_v_e
  110.            Copy directories    recursively.
  111.  
  112.       --_h_e_l_p
  113.            Print a usage message on    standard output    and exit
  114.            successfully.
  115.  
  116.       --_v_e_r_s_i_o_n
  117.            Print version information on standard output then exit
  118.            successfully.
  119.  
  120.       -_S, --_s_u_f_f_i_x _b_a_c_k_u_p-_s_u_f_f_i_x
  121.            The suffix used for making simple backup    files can be
  122.            set with    the SSSSIIIIMMMMPPPPLLLLEEEE____BBBBAAAACCCCKKKKUUUUPPPP____SSSSUUUUFFFFFFFFIIIIXXXX environment variable,
  123.            which can be overridden by this option.    If neither of
  124.            those is    given, the default is `~', as it is in Emacs.
  125.  
  126.       -_V, --_v_e_r_s_i_o_n-_c_o_n_t_r_o_l    {_n_u_m_b_e_r_e_d,_e_x_i_s_t_i_n_g,_s_i_m_p_l_e}
  127.  
  128.  
  129.  
  130.      Page 2                         (printed 5/18/98)
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.      CCCCPPPP((((1111))))         FFFFSSSSFFFF ((((GGGGNNNNUUUU FFFFiiiilllleeee UUUUttttiiiilllliiiittttiiiieeeessss))))         CCCCPPPP((((1111))))
  138.  
  139.  
  140.  
  141.            The type    of backups made    can be set with    the
  142.            VVVVEEEERRRRSSSSIIIIOOOONNNN____CCCCOOOONNNNTTTTRRRROOOOLLLL environment variable, which can be
  143.            overridden by this option.  If VVVVEEEERRRRSSSSIIIIOOOONNNN____CCCCOOOONNNNTTTTRRRROOOOLLLL is not
  144.            set and this option is not given, the default backup
  145.            type is `existing'.  The    value of the VVVVEEEERRRRSSSSIIIIOOOONNNN____CCCCOOOONNNNTTTTRRRROOOOLLLL
  146.            environment variable and    the argument to    this option
  147.            are like    the GNU    Emacs `version-control'    variable; they
  148.            also recognize synonyms that are    more descriptive.  The
  149.            valid values are    (unique    abbreviations are accepted):
  150.  
  151.            `t' or `numbered'
  152.             Always make    numbered backups.
  153.  
  154.            `nil' or    `existing'
  155.             Make numbered backups of files that    already    have
  156.             them, simple backups of the    others.
  157.  
  158.            `never' or `simple'
  159.             Always make    simple backups.
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.      Page 3                         (printed 5/18/98)
  197.  
  198.  
  199.  
  200.